IMS Enterprise

О IMS Enterprise

MS Enterprise — это международный стандартный формат XML-файлов, который может использоваться для создания и обновления учетных записей пользователей, записи и отмены записи пользователей на курсы, назначения ролей, создания курсов и категорий курсов, а также обновления полных и кратких названий курсов.

Использование данного метода зачисления

Для использования метода зачисления IMS Enterprise его необходимо включить в разделе "Управление плагинами зачисления" в административной панели.

Метод IMS Enterprise импортирует XML-файл с вашего сервера YooLearn. Укажите "Расположение файла" как полный путь к вашему XML-файлу (локально на сервере, например, /home/user/imsenterprise/file.xml).

IMS Enterprise не добавляется в курсы напрямую — вместо этого импорт выполняется непосредственно на странице "Администрирование" → "Плагины" → "Зачисления на курсы" → "Файл IMS Enterprise". Для этого нажмите ссылку "Выполнить импорт IMS прямо сейчас" или запустите cron.

Обзор формата

Ниже представлено простое руководство по базовой структуре типичного файла данных IMS Enterprise. Более подробная информация доступна на официальном сайте IMS Enterprise.

Вы также можете ознакомиться с Сводкой по соответствию, где описано, какие элементы данных IMS может обрабатывать этот плагин.

Базовое руководство по формату файла IMS Enterprise

Для любого типа зачисления в стиле IMS вам понадобится:

Тег <group>, определяющий курс,
Тег <person>, указывающий на учётную запись пользователя,
Тег <membership>, содержащий теги <member>, которые определяют роль пользователя в данном курсе.

Помните, что числовые ключи, используемые в базах данных YooLearn, не являются взаимозаменяемыми данными — система учёта студентов никогда заранее не узнает, что Джо был 20-м пользователем, добавленным в базу данных YooLearn. Поэтому в этом типе данных используются не они.

Обычно курс имеет как код, так и название. Допустим, его код — YooLearn101. Если вам нужно разместить новый курс в категории, отличной от стандартной, вы можете указать её с помощью тега <orgunit>. Для определения курса можно использовать следующий код:

<group>
  <sourcedid>
    MyDataSystem
    <id>YooLearn101</id>
  </sourcedid>
  <description>
    <short>YooLearn 101</short>
    <long>YooLearn 101: Название курса</long>
  </description>
  <org>
    <orgunit>CATEGORY</orgunit>
  </org>
</group>

Скрипт зачисления будет искать курс с кодом YooLearn101 и (опционально) создаст его, если он не существует. Плагин также позволяет сопоставлять теги <group> с полями shortname, fullname и summary курса.

Аналогично для пользователя — предположим, это jYooLearn:

<person>
  <sourcedid>
    MyDataSystem
    <id>jYooLearn</id>
  </sourcedid>
  <userid>jYooLearn</userid>
  <name>
    <fn>Joe YooLearn</fn>
    <n>
      <family>YooLearn</family>
      <given>JOE</given>
    </n>
  </name>
</person>

Если у Джо ещё нет учётной записи, скрипт может (опционально) создать её.

Теперь рассмотрим добавление пользователя в курс через <membership>:

<membership>
  <sourcedid>
    MyDataSystem
    <id>YooLearn101</id>
  </sourcedid>
  <member>
    <sourcedid>
      MyDataSystem
      <id>jYooLearn</id>
    </sourcedid>
    <role roletype="01">
      <status>1</status>
      <extension><cohort>unit 2</cohort></extension>
    </role>
  </member>
</membership>

Спецификация IMS Enterprise позволяет указывать даты начала и окончания зачисления с помощью тега <timeframe>, если это необходимо.

Если пользователь уже добавлен в группу внутри курса, скрипт не будет изменять это. Однако если он не состоит в группе, то указанная группировка будет применена.

Автоматическое создание новых курсов

При необходимости плагин IMS Enterprise может автоматически создавать новые курсы для всех тех, которые найдены в данных IMS, но отсутствуют в базе данных YooLearn.

Сначала курсы проверяются по их полю "idnumber" — это буквенно-цифровое поле в таблице курсов YooLearn, которое может содержать код, используемый для идентификации курса в студенческой информационной системе (например). Если курс не найден по этому полю, система ищет его по "короткому названию" — краткому идентификатору курса, который отображается в навигационной цепочке и других элементах интерфейса. (В некоторых системах эти два поля могут совпадать.) Только если поиск по обоим полям не дал результатов, плагин может (в зависимости от настроек) создать новый курс.

Все вновь созданные курсы по умолчанию остаются СКРЫТЫМИ. Это предотвращает возможность случайного доступа студентов к полностью пустым курсам, о которых преподаватель может не знать.

Отчисление студентов/преподавателей

При необходимости, данные Enterprise могут как добавлять, так и удалять записи на курсы — как для студентов, так и для преподавателей. Если эта настройка включена, YooLearn будет выполнять отчисление в соответствии с указанными данными. Вручную удалить участника нельзя.

Существует три способа отчислить студентов с помощью данных IMS:

Элемент <member>, указывающий конкретного студента и курс, с элементом <status>, установленным в 0 (что означает «неактивен»).
Второй способ немного отличается. Он не требует активации этой настройки и может быть указан заранее, до даты отчисления:
Элемент <member>, содержащий <timeframe> для записи, может указывать дату начала и/или окончания доступа студента к курсу. Эти даты загружаются в таблицу данных о записях YooLearn, если они указаны, и после окончания срока студент больше не сможет получить доступ к соответствующему курсу.

Оригинал: https://docs.moodle.org/502/en/IMS_Enterprise

О IMS Enterprise​

Использование данного метода зачисления​

Обзор формата​

Базовое руководство по формату файла IMS Enterprise​

Автоматическое создание новых курсов​

Отчисление студентов/преподавателей​